home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / spitfire / newchat.zip / SYSOP.ZIP / SYSOP.DOC < prev   
Text File  |  1996-01-21  |  26KB  |  502 lines
  1.         NEWCHAT Version 3.54 --  Program & Design by Richard Levasseur
  2.                              Copyright (C) 1996
  3.  
  4.                                   DISCLAIMER
  5.  
  6.         The author has taken every precaution to insure that no harm
  7.         or damage will occur on computer systems operating this package.
  8.         Nevertheless, the author shall NOT be held liable for whatever
  9.         may happen on your computer system or to any computer systems
  10.         which connects to your own as a result of operating this package.
  11.         The user assumes full responsibility for the correct operation of
  12.         this software package, whether harm or damage results from software
  13.         error, hardware malfunction, or operator error. NO warranties are
  14.         offered, expressly stated or implied, including without limitation
  15.         or restriction any warranties of operation for a particular purpose
  16.         and/or merchantability.  If you do not agree with this then do NOT
  17.         use this program.
  18.  
  19.                                 LICENSE AGREEMENT
  20.  
  21.         The DOOR program, support files, and documentation are
  22.         copyrighted products of the AUTHOR.  The AUTHOR reserves all rights
  23.         to these products. This is protected by the United States of America
  24.         (USA) and International Copyright Laws. In no way shall the
  25.         components of the DOOR software package be reproduced
  26.         or modified in any form or method without prior expressly written
  27.         permission from the AUTHOR.
  28.  
  29.         Tampering with or altering the contents or integrity of the Door
  30.         software package is prohibited. No fee may be charged by any
  31.         agency other than the AUTHOR beyond the cost of distributing
  32.         unregistered copies without prior expressly written permission from
  33.         the AUTHOR.
  34.  
  35.         A major portion of this software was written by Scott Baker and
  36.         Steven Lorenz. Mr. Baker's Doordriver kit and the changes made
  37.         by Mr Lorenz have been used for the communications and interrupt
  38.         handling and this part of the software remains copyrighted by them.
  39.  
  40.         This DOOR is distributed under the Shareware concept. You are
  41.         allowed to operate this DOOR for a trial period of thirty (30)
  42.         days. After this trial period, you must register the DOOR 
  43.         or discontinue its usage. Again if you do not agree with this
  44.         then do NOT use this DOOR.
  45.  
  46.      
  47.                              INTRODUCTION:
  48.                              ------------
  49.  Ok, This is new.  I've seen many chat rooms on many sytems.  The problem
  50.  I've always seen with most of them is they either require one user to
  51.  finish typing before the other can begin, or a user may ask another user
  52.  a question that they do not see the answer to until the reply is complete.
  53.  This creates a kinda game I call chat tag.  One user is writting back, 
  54.  while the other is writting "Hey where did you go..".  Well, this helps.  
  55.  
  56.  One problem, and as of yet, incorrectable, ASCII users are in the dark.
  57.  The users must be using rip or ANSI terminals to use this chat.
  58.  
  59.  My NEWCHAT will split in up to 4 simultaneous windows that all users can 
  60.  type in at the same time.  It includes action commands, and a way for the
  61.  sysop to configure some commands for adult access users.  All the users 
  62.  must have that level or higher to get these actions.  It has taken over
  63.  8 months of work on this product.  If you run more than 4 nodes, or just 
  64.  three nodes and you join in locally, the 5th person who tries to join in
  65.  the chat room will be told the chat room is currently full.  You may add
  66.  more rooms in other door options for more rooms.  The only draw back is
  67.  only 4 people per room.  But this is a much easier chat room to follow
  68.  as a user and people do enjoy it on my system.  It has a TREK Style look
  69.  in ripterm, and has been tested with Rip 1.54 and 2.0+  It autodownloads
  70.  the missing icons, and will display the sysops photo at the end if one
  71.  is available.  The JPG for Rip 2.0+ is named the last 8 letters of the
  72.  sysop's last name.  Example: For my BBS, LEVASSEU.JPG.  If one is not
  73.  available the NONE.JPG is sent.  Rip 2.0 users even enjoy a sound clip
  74.  with thier CHAT.  The sound is produced each time a user enters or leaves
  75.  the chat room.  If a user is already in the chat, and someone else
  76.  is about to join, but is delayed by having to download the missing icons,
  77.  the user waiting is informed of this.
  78.  
  79.                              REQUIREMENTS:
  80.                              ------------
  81.  At this point in time the only requirements are FILES=10 (or more) in your
  82.  config.sys file.  ANSI.SYS or DVANSI with SHARE must also be loaded.  
  83.  YOU MUST ALSO   BE RUNNING RAMDRIVE ON YOUR SYSTEM.  A FOSSIL is NOT 
  84.  required to run the Door, although one will be supported if it exists. 
  85.  Automatic time slicing support is provided to most common multi-taskers as 
  86.  well.  And while a JPG loads, it shows the image in a special area on the
  87.  screen.  Please read installation info.  I currently have no trouble 
  88.  running this on a 486DX-40 with two nodes and a local with 8 meg of mem.
  89.  
  90.                             Files Included
  91.                             --------------
  92.  Below is a listing of all files for the this Door.  If you are
  93.  missing ANY of these files (except for the DOC and FRM files), the Door
  94.  will NOT function.  Feel free to give out copies of the ENTIRE archive
  95.  package of this Door but please make sure all the files below are in that
  96.  package:
  97.  
  98.  
  99.   SYSOP.ZIP                    - This documentation with all the other    
  100.                                  docs. for registration and installation.
  101.  
  102.   NEWCHAT.EXE                  - Main Executable Door File
  103.  
  104.   CHATSET.EXE                  - Set up program to create the required
  105.                                  NEWCHAT.CTL file.  Answer all the questions.
  106.                                  Just type VARSET for help.  If you want
  107.                                  to edit an existing CTL then type its name
  108.                                  after VARSET.
  109.  
  110.   NEWCHAT.CTL                  - WARNING - THIS FILE MUST BE ALTERED TO YOUR
  111.                                            SYSTEM.  It is the control file.
  112.                                            RUN VARSET for OPTIONS!
  113.  
  114.   UPLOAD1.BAT - UPLOAD2.BAT    - Example of BAT files used to implement 
  115.                                  external transfers from two different nodes.
  116.                                  Using DSZ.EXE, DSZ.COM or GSZ.COM will give
  117.                                  you the download YMODEM ability.  The number
  118.                                  after the upload filename is the node number.
  119.                                  
  120.                                  *YMODEM WAS USED TO STOP RIP 1.54 FROM
  121.                                   USING RECOVERY ZMODEM WHILE SENDING SAME
  122.                                   NAME FILES. SEE UPLOAD BATCH FILES FOR USE
  123.                                   WITH GSZ, WORKS WITH DSZ TOO.
  124.  
  125.   ACTIONS.DAT                  - List of Available Actions in the chat.
  126.                                  Formated like this..  
  127.                                  00 - Level
  128.                                  Menu Item
  129.                                  Phrase to say with %1 to place a name.
  130.                                  NAME.ANS <-Name of ANSI to show with two 
  131.                                             nodes.
  132.                                  See Example..
  133.  
  134.                                  < INCLUDED ANSI FILES MAY BE CHANGED >
  135.                                  BEBACK.ANS  FRENCH.ANS  HUG.ANS  NUDGE.ANS
  136.                                  FINGER.ANS  FROWN.ANS   HUH!.ANS PUNCH.ANS
  137.                                  ROSE.ANS    SMILE.ANS   
  138.  
  139.                                  < INCLUDED ANSI FILES DO NOT CHANGE >
  140.                                  INCOMING.ANS  NOROOM.CLR  PAGE.ANS
  141.                                  PAGE2.ANS     TIME.CLR
  142.                                
  143.   COMM_OFF.WAV                 - WAV played when a user leaves chat.
  144.   
  145.   COMM_ON.WAV                  - WAV played when a uesr joins chat.
  146.   
  147.   COMCODE.WAV                  - WAV played when first entering chat.
  148.   
  149.   DCEARTH.ICN                  - ICN shown when leaving chatroom. RIP 1.54
  150.   
  151.   NONE.JPG                     - JPG shown when the sysop photo is not 
  152.                                  available at end.
  153.   
  154.   UFPII.ICN                    - Icon shown on welcome to chat for Rip 1.54
  155.   
  156.   UFPII.BMP                    - Icon shown on welcome to chat for Rip 2.0+
  157.  
  158.  
  159.   WHOSON.EXE                   - Special Free Pogram for USE by Spitfire BBS
  160.                                  Operators.  Will change the appearance of
  161.                                  the (W)ho's on node option to users.
  162.                                  If placed in the Batch to run the chat, 
  163.                                  other users will be told that another user
  164.                                  on the other node is "IN NODE CHAT".
  165.                                  RUN WHOSON.EXE to see options. Place in
  166.                                  Spitfire's work directory.
  167.  
  168.  Files created by the Door when errors are encountered:
  169.  
  170.  ERROR.LOG    - Log of system errors which happen during Door play.
  171.  
  172.                            Installation
  173.                            ------------
  174.  
  175. -->    NOTE:  The word "Door" is used in place of the program name for
  176.               both the executable file (example Door.EXE), and the CTL
  177.               file (Example Door.CTL) in the documentation from this
  178.               point on. DoorDIR is used in place of the program directory
  179.               in the documentation from this point on.
  180.  
  181. --> UPGRADE:  Once you register the codes given will work with any new 
  182.               version that may come out.
  183.  
  184.  1. Create a directory for the Door (example: "WC30\DOORS\DoorDIR")
  185.  
  186.  2. Make sure that ALL files listed above from the Door package
  187.      are moved into that directory.
  188.  
  189.  3. Use chatset.exe newchat.CTL.
  190.  
  191.  4. Answer all the questions correctly.  
  192.  
  193.  5. To insure proper multi-node use DOS SHARE must be loaded prior to
  194.      the Door and prior to DESQview.  And create a RAMDRIVE. See DOS
  195.      book, or use HELP RAMDRIVE for 6.0+ users.
  196.  
  197.  6. In order to run the Door program online the following parameters may
  198.      be used.
  199.  
  200.       "/Bxxxxx"   This tells Door.EXE to lock its baud rate at
  201.       xxxxx.  In order to get the most efficiency out of a high speed
  202.       error correcting modem (9600 baud or above), you may lock the baud
  203.       rate to a speed higher than what the caller is actually using.
  204.       By locking the baud to say 38,400, the modem can compress text data
  205.       that is being sent and achieve a baud rate much higher than the
  206.       actual transmission rate.
  207.       This will lock the baud rate at the same value for all nodes that
  208.       use this command line.  If you perfer a more selective way to lock
  209.       baud use 'LOCKBAUD' command in the Door.CTL file.
  210.  
  211.       "/Cx"     (where x is 1..4) This specifies a comport number.
  212.       Some bbs software does not create door information files (dropfiles)
  213.       that contain the comport number.  If your bbs does have a comport
  214.       listed in the dropfile then there is no need for this parameter.
  215.       The default is comport 0, local mode.
  216.  
  217.       "/E" - Expanded Memory Specification If your machine has over one
  218.       megabyte of memory, then you may have some available.  Door.EXE can
  219.       utilize EMS to improve Door performance and reduce conventional
  220.       memory requirements.
  221.       This command will tell Door.EXE   to use EMS memory to hold its
  222.       overlay buffer.  Otherwise disc area may be used to hold this buffer.
  223.       This needs a memory manager and when enabled and is compatible with
  224.       DESQview.
  225.  
  226.       "/L"      This tells Door.EXE to load up in LOCAL mode.
  227.       This is good for testing or when a sysop just wants to "try out" the
  228.       door without messing with his BBS setup.  The "/L" mode will ask the
  229.       user for his name and run the door in local mode.
  230.       
  231.       "/Nx"     (where x is 1..9) This specifies a "node number".
  232.       Some bbs software support multinode environments in which you must
  233.       know the node number of the drop file to use. For example, RBBS-PC
  234.       uses DORINFOx.DEF. If you specified "/N2" then Door.EXE would use
  235.       DORINFO2.DEF.
  236.  
  237.       "/Mx"     (where x is up to 2 filename acceptable characters)
  238.       Used to specify one of Multiple control files.  If you have created
  239.       more than one Door.CTL file (Door1.CTL, Door2.CTL, etc.) for each
  240.       node or network PC then you can select the one you want by using
  241.       the /M parm.
  242.       Example:  "/M2" will force Door.EXE to use Door2.ctl.
  243.  
  244.       "/Pyyy"   This specifies the path to the drop files.
  245.       For example, "/PC:\WILDCAT\WCWORK\NODE1" would tell Door.EXE to
  246.       look for the drop file in C:\WILDCAT\WCWORK\NODE1. If this is left
  247.       out the program assumes the drop file is local.
  248.  
  249.       "/V"    This command will tell Door.EXE not to show any display
  250.       on the local screen.  Only a colored screen and a message will be
  251.       displayed.  The cursor will not move as it will be turned off.
  252.       Saves a little processing on multi-tasking systems.
  253.  
  254.       "/W"      This flags the program that a network is present even
  255.       though no multitaskers are detected.  This is useful if the door is
  256.       run on a network such as Novell that doesn't use multitaskers.
  257.  
  258.         COMMON ERRORS
  259.         003  File path not found. Check to make sure the Door directory is
  260.               correctly named as DoorDIR.
  261.         201  Files not found. Check to make sure that all required Doors
  262.               files are in the DoorDIR directory.
  263.  
  264.  7. Install the door into your BBS software (see your BBS software
  265.     documentation for more information).  A batch file is normally
  266.     used to do this.  To run the program just have your batch file
  267.     change to the DoorDIR directory and run Door.EXE - Thats all there
  268.     is to it!  For dorinfo systems use the following: 
  269.  
  270.                             Sample Batch File Entry
  271.                             -----------------------
  272.        For node 1 running on Spitfire with extra free file..
  273.        
  274.        CD\SF\WORK
  275.        WHOSON 1 N
  276.        NEWCHAT /N1 /Pc:\sf
  277.        CD \SF
  278.  
  279.  
  280.  9.  Surprise!  There is NO daily maintenance to be performed.
  281.  
  282.  
  283.                   RESTRICTIONS ON THE UNREGISTERED Door
  284.                   -------------------------------------
  285.  Until the Door is registered the following restrictions are in effect:
  286.  
  287.  a.  The users only be allowed to chat for 10 mins at a time..
  288.      
  289.  b.  And the users will only be allowed to use one action command per 
  290.      chat sesion.  .
  291.  
  292.  c.  All of the above will no longer be in effect once registered.
  293.  
  294.  d.  Once you are registered any future updates can be obtained free
  295.      through my BBS and my upgrades are ALWAYS easy to implement!
  296.  
  297.  e.  I am always improving my Doors - so check my BBS for a more current
  298.      version.   Galaxy Class BBS (207) 582-8392 two nodes!  They Hunt for
  299.      the free line.  14.4 on both currently.
  300.  
  301.  
  302.                      WHAT TO DO IF THERE ARE PROBLEMS
  303.                      --------------------------------
  304.  
  305.  Every effort is made to ensure that the Door runs correctly before it leaves
  306.  my BBS as Shareware.  If you are experiencing problems please do the
  307.  following BEFORE calling me:
  308.  
  309.      Read ALL the SYSOP.DOC to ensure you have setup the program
  310.      and have met all the program requirements.
  311.  
  312.                              
  313.                              Multinode use
  314.                              -------------
  315.  This Door supports multinode use and provides automatic multi-tasker
  316.  support  (time slice releasing) for a wide variety of multi-taskers.
  317.  
  318.            Common Problems (Locked Bauds, High Speed modems, etc)
  319.            ------------------------------------------------------
  320.  
  321.  1.   The Door does NOT require a fossil driver to run.
  322.  
  323.  2.   If you are running a high speed modem (9600 baud or above), then I
  324.       suggest you run your bbs/mailer/doors at a locked baud rate. On high
  325.       speed error correcting modems, locking the baud rate will have a
  326.       noticeable increase on the speed of text that is sent. It's beyond
  327.       the scope of this document to discuss configuring your BBS and
  328.       mailer for a locked baud rate; you may wish to consult those docs
  329.       for information on that. Here are a few things to keep in mind when
  330.       setting up Door with a locked baud rate:
  331.  
  332.       a.  When using a locked baud rate, I highly recommend using a FOSSIL
  333.           driver. This Door will work at high speeds without one though.
  334.           BNU is a good fossil driver which can even be loaded and unloaded
  335.           before and after you run this Door.
  336.  
  337.       b.  If you are using a fossil, then make sure to tell the fossil
  338.           that the port is locked. For BNU, to lock com1: at 38,400, you
  339.           would use something like "L0=38400" on BNU's command line.
  340.  
  341.       c.  If you lock the baud for one program, it must be locked
  342.           for everything. You can't lock the baud for just this Door, but
  343.           not your BBS/mailer.
  344.  
  345.       d.  You may need to use the /B switch on the Door.exe Command line
  346.           to specify the locked baud rate. For 19,200 this would be "/B19200"
  347.           and for 38,400 this would be "/B38400". Please note there is no
  348.           space between the "/B" and the baud rate.
  349.  
  350.  3.   What follows is some information on possible strange situations
  351.       that may occur:
  352.  
  353.       a.  Low speed users can play the Door, but high speed users get
  354.           garbage.
  355.      
  356.           - If you are not using the DORINFOx.DEF or DOOR.SYS drop file
  357.             then you may wish to find a converter program to convert
  358.             whatever drop file your BBS produces to the DORINFOx.DEF
  359.             or DOOR.SYS format and tell Door.exe to use that.
  360.  
  361.             Several converter programs are readily available on most
  362.             BBS systems. CallDoor is a good one if you can find it.
  363.  
  364.       b.  The Door hangs up when a user enters the Door.
  365.  
  366.           - Sounds like the Door is getting the wrong baud rate somehow.
  367.             Try switching over to the DOOR.SYS drop file method
  368.             if possible.
  369.  
  370.       c.  Text and screens are getting cut off.
  371.  
  372.           - If you are running with a locked baud, then this could
  373.             be caused by some sort of FLOW CONTROL problem. Try using
  374.             a fossil if you aren't already.
  375.  
  376.       d.  If you're using something other than the DOOR.SYS drop file,
  377.           then I always suggest trying to use DOOR.SYS if possible. It is
  378.           the most reliable method and has had the most testing. If that
  379.           is not possible try DORINFOx.DEF as an alternative.
  380.  
  381.       e.  A door locks up node 1.  This can happen with fossils or the
  382.           internal communications routines because it uses the default
  383.           comport of 1 when NONE is found in the dropfile or Door.ctl
  384.           file. To correct this make sure the right port is shown in
  385.           the dropfile OR Door.ctl file.
  386.  
  387.       f.  ANSI is reflected correctly on the local screen but the user
  388.           is getting garbage.  Assuming the user has ANSI installed then
  389.           most likely the problem is at your end. First make sure you
  390.           have configured the Door.ctl file to show the correct locked
  391.           port rate. Second make sure the dropfile is passing the locked
  392.           port rate INSTEAD of the actual conncet rate.  If it is not
  393.           passing the locked port rate then you may need to use a
  394.           different dropfile format OR use a dropfile converter program
  395.           to change the line to show the locked port rate INSTEAD of
  396.           the actual connect rate.
  397.  
  398.  
  399.                               CREDITS:
  400.                               --------
  401.  This relatively small section is just to recognize the GOOD people
  402.  who have made the DDPLUS based Door a possibility.
  403.  
  404.  Shirley Robbins   -=*=-  I could not have accomplished this without 
  405.                           you.  Your patience and care has made the hours
  406.                           I've spent on this easier.  You have shown me
  407.                           great love, and stood by me while I fought this
  408.                           endeavor.  Most Girlfriends or wives would
  409.                           have complained or left because of all the
  410.                           time I was spending not being there to do
  411.                           other things.  THANKS YOU so much.  You,
  412.                           Shirley, are the most important part of my
  413.                           life.  I'm glad you didn't forget.
  414.  
  415.  Scott Baker       -=*=-  The authors of the original DoorDriver Kit
  416.  and                       are to be thanked for releasing the
  417.  Derrick Parkhurst         source code to their great kit!  Without
  418.                            that act of kindness DDPLUS would NOT
  419.                            be possible and neither would this Door.
  420.                            Scott is the author of several door Doors,
  421.                            most notably Land of Devastation,
  422.                            which uses the original doordriver kit.
  423.  
  424.  Steven Lorenz      -=*=- The author of the enhanced add on package
  425.                            to Scott Bakers DoorDriver Kit. Thanks to
  426.                            his code modifications, add ons and enhancements
  427.                            DDPLus is a much more complete and capable
  428.                            package then originally released in the
  429.                            DoorDriver Kit. 
  430.                            Steve is the author of several door Doors, most
  431.                            notably Railroad Empires, Romans At War, and
  432.                            Empires at War, all of which use DDPlus.
  433.  
  434.  Bob Dalton         -=*=- The author of most of the DDPLus documentation
  435.                            and contributor of the MISC.PAS and INITOVER.PAS
  436.                            units used in the Door. Bob is the author of
  437.                            several door Doors, such as GodFather of Crime,
  438.                            Rise To Power, Task Force Broadside, Ship of the
  439.                            Line, Grunt Fest, Way Freight and the Adventure
  440.                            Door Door Toolkit, all of which use DDPLus.
  441.  
  442.  DESQview is a registered trademark of Quarterdeck Office Systems.
  443.  Ripscript & Ripterm are registered trademarks of TeleGrafix Communications.
  444.  Spitfire was created and owned by Mike Woltz.                  
  445.  
  446.                            Where to reach me
  447.                            -----------------
  448.  
  449.  I can usually be reached at my BBS system, which should be listed in the
  450.  section entitled "registration" which is below.
  451.  
  452.  
  453.                              Registration
  454.                              ------------
  455.  If you or your users enjoy this Door, then please register it.
  456.  Registration is $10.00 and you get a REGISTRATION code by mail or 
  457.  posted on my BBS which will disable the UNREGISTERD portions, and 
  458.  entitle you to life time support through my BBS.  BBS Support 
  459.  includes unlimited free updates and upgrades (not like some door 
  460.  Door authors who charge for major upgrades/updates!) through my 
  461.  BBS and access to the Door support conference on my BBS.  
  462.  To register this Door just print out the registration form 
  463.  (REGISTER.FRM) file included with the Door and send it with your 
  464.  check or money order for $10.00 to:
  465.                     
  466.                        Richard LeVasseur
  467.                        127 Brunswick Ave. Apt #3
  468.                        Gardiner, ME 04345
  469.  
  470.  
  471.                      HOW TO REACH ME BY MODEM
  472.                     ---------------------------
  473.  
  474.                        Galaxy Class BBS (USA)
  475.                (207) 582-8392  (2400 to 14400 baud)
  476.                Two nodes!  The open Node will Answer    
  477.                 
  478.  Reminder: You will be mailed a LETTER with your registration code.
  479.  Just allow an appropriate amount of time (a week or two) after dropping your
  480.  check in the mail for it to arrive to me and the code to be sent by mail
  481.  back to you.  If you need it sooner log onto my BBS, leave me a message
  482.  telling me you mailed the registration and when I receive your check or
  483.  money order I will post a private message on the BBS giving you the key
  484.  code.  If you do it this way please allow at least a week from the time
  485.  you mail it to the time you call and get your code. If you go the BBS
  486.  route you will ALSO receive a key code by mail.  REMINDER: No disks are 
  487.  sent, if you need the most current version you must call my BBS for it.
  488.  Your code will work on all future updates to this package!
  489.  
  490.  
  491.                    Bug Reports/Comments/Suggestions
  492.                    --------------------------------
  493.  I have made every attempt to make sure the Door is free of bugs, BUT the
  494.  possibility always exists that one may have been missed by me or the
  495.  playtesters.  If you find a bug, or have a suggestion or comment to make
  496.  leave a message on my BBS or Write to me.  Please be very clear about what
  497.  happened.  what system you are using ect..
  498.  
  499.  Thanks for using my DOOR.
  500.  -Rich
  501.  
  502.